home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / os2 / ultra06c.zip / ultradd.doc < prev    next >
Text File  |  1994-11-23  |  12KB  |  319 lines
  1. Unofficial Advanced Gravis Ultrasound Drivers #2 ("Manley Drivers")
  2. Copyright 1994 Robert J. Manley and Multi-Player Computer Adventures
  3. Version 0.6c - SHAREWARE - please read the REGISTRATION section for details
  4.  
  5. FEATURES
  6.  
  7.     - basic GUS rev 3.7 and MAX/daughtercard mixer support
  8.     - 8 or 16 bit wavefile playback
  9.     - mono or stereo
  10.     - hardware MIDI playback (to an external synth or synth module)
  11.     - volume and balance control
  12.     - multi-session (many registered streams - one active)
  13.     - Ultrasound specific OS/2 VDD giving DOS sessions:
  14.       - reduced interrupt latency
  15.       - hardware virtualization
  16.       - MIDI port emulation of Roland MPU-401 in UART mode
  17.         (allowing WinOS2 to load and use those drivers - hooray!)
  18.       - GM emulation for DOS and Windows sessions under OS/2 with
  19.         the goody pack which is only sent to registered users
  20.     - absolute lowest system overhead possible
  21.     - rigorous testing
  22.  
  23.  
  24. Here is what it has been tested and known to work with:
  25.  
  26.     - OS/2 2.1 with MMOS2 CSD, OS/2 2.11 (with its MMOS2 CSD), Warp!
  27.     - system sounds
  28.     - digital audio applet
  29.     - MIDI applet
  30.     - compact disc applet and CD explorer (bug in version 2.3 hangs
  31.       PM message queue when using digital transfer)
  32.     - bigben2
  33.     - dmplayer 1.01
  34.     - video player / Ultimotion
  35.     - wave doctor
  36.     - multimedia mahjongg
  37.     - GUSmixer (even while the device is in use!)
  38.     - play.cmd (thanks to TFS for reminding me about this one)
  39.     - WinOS2 apps
  40.       - media player
  41.       - Cakewalk Pro
  42.       - Midisoft Recording studio
  43.  
  44.  
  45. INSTALLATION
  46.  
  47. *** STEP #1 ***
  48. This driver requires one of the following to be installed:
  49.  
  50.     - OS/2 Warp (with MMOS2 installed) Beta I, Beta II, or GA
  51.     - OS/2 2.11 MMOS2 from either
  52.         - OS/2 2.11 refresh package
  53.         - OS/2 2.1 + Feb '94 Service Pack (== OS/2 2.11)
  54.     - OS/2 2.1 MMOS2 + November '93 MMOS2 CSD
  55.       (ftp-os2 in pub/os2/ibm/os2fixes as MMPMCS.DSK)
  56.  
  57. If neither of these versions of MMOS2 can be found, the installation will
  58. fail and nothing will be added to your CONFIG.SYS.
  59.  
  60. *** STEP #2 ***
  61. Use an OS/2 based unzip program (e.g. Info-Zip's) to unpack ULTRA05E.ZIP to a
  62. directory on your hard disk or floppy.  From that directory, run "MINSTALL",
  63. accept it as the source, and then proceed with the installation.  The following
  64. lines will be appended to your CONFIG.SYS:
  65.  
  66.     DEVICE=<drive>:\MMOS2\ULTRADD.SYS /B:b /C:c /D:d /U:u /M:m /V
  67.     DEVICE=<drive>:\MMOS2\ULTRAVDD.SYS
  68.  
  69. where (with defaults):
  70.  
  71.     b - base I/O address of Ultrasound (220)
  72.     c - base address of 16-bit CODEC (32C)
  73.     d - DMA channel for playback (7)
  74.     u - GF1 IRQ (12)
  75.     m - MIDI IRQ (5)
  76.  
  77. If you have a 16-bit daughtercard, you must manually change the address (in
  78. hex) following the /C: switch to the base address for that board.  The valid
  79. addresses for the daughtercard are: 530, 604, E80, and F40.  You may install
  80. this software over a previous version without first uninstalling.  Also note
  81. that the driver can be UNINSTALLED by selecting the number of Ultrasounds to
  82. install as zero.
  83.  
  84. *** IMPORTANT STEP #3 (NEW) ***
  85. If you have previously installed an earlier version of this driver since
  86. installing your current system, you must read this step carefully and follow
  87. all instructions.  There is a limitation in the MMOS2 installation program
  88. which forces the user to manually edit the CONFIG.SYS.  After installing this
  89. software, search for a line containing the token "AUDIOVDD" such as the
  90. following:
  91.  
  92.     DEVICE=<drive>:\MMOS2\AUDIOVDD.SYS ULTRA1$
  93.  
  94. If this line is present as shown here, comment it out with a REM statement at
  95. the beginning.  If you have another OS/2 supported soundcard installed and
  96. this line contains other tokens (e.g. "PAS161$"), try these two things in
  97. order of preference:
  98.  
  99.     1. delete just the "ULTRA1$" token from this line and install
  100.     2. after installing this software and experiencing problems with
  101.        GUS sound in DOS boxes, put back the "ULTRA1$" token and REM
  102.        out the ULTRAVDD.SYS line.  Sorry, no emulations for you.
  103.  
  104. If I had more than one soundcard installed, I could check this but I don't :(.
  105.  
  106.  
  107. HARDWARE EMULATIONS
  108.  
  109. In addition to virtualizing the Ultrasound I/O ports to DOS sessions, the
  110. supplied OS/2 virtual device driver (VDD) ULTRAVDD.SYS also emulates the
  111. following devices when selected in the AUDIO_ADAPTER_EMULATION DOS setting:
  112.  
  113.     - Roland MPU-401 MIDI interface in UART mode (e.g. Windows).
  114.       Select I/O address of 0x330 and IRQ of 2/9 (not used yet).
  115.       MIDI is re-routed through the GUS MIDI port to an external synth
  116.       (not played natively as in MegaEm).
  117.  
  118. **** NOTE: native DOS GM emulation is now done! (like MegaEm for OS/2)
  119. **** Register this software and get the files required to enable this
  120. **** functionality by e-mail or if neccessary, ground mail
  121.  
  122. Future directions are to add Sound Blaster and enhance Roland emulation.
  123.  
  124. Please note that neither SBOS or MegaEm should be run under an OS/2 DOS
  125. box.  These programs require features of the 386 that cannot be granted
  126. to a VDM under a protect mode OS without comprimising system integrity.
  127.  
  128.     UNDER NO CIRCUMSTANCES SHOULD SBOS or MEGAEM BE RUN!
  129.  
  130.  
  131. WinOS2 CONFIGURATION
  132.  
  133. It is recommended that all WinOS2 users keep a separate copy of their
  134. SYSTEM.INI and CONTROL.INI files for real Windows and WinOS2.  Doing this
  135. will allow the Gravis supplied Windows drivers to work while under real
  136. Windows and these drivers to provide MPU-401 emulation under WinOS2.  A
  137. good system to use is to copy each of these files to another with the same
  138. filename root but with the extension ".DOS" after a successful run of real
  139. Windows.  Do the same with the extension ".OS2" after running this setup
  140. without problems.  Before starting either system, copy the OS specific
  141. versions over their proper files.  PLEASE BE CAREFUL with this and take
  142. the time to understand what you are actually doing!
  143.  
  144. The first thing to do is get rid of all references to the Gravis drivers
  145. in your Window's SYSTEM and CONTROL ini files (of course, this is only
  146. after you've already made backup copies of these files for real Windows
  147. as described above).
  148.  
  149. These are the lines in your real Windows SYSTEM.INI to comment out with a
  150. ';' character at the beginning to disable Gravis' drivers and avoid that
  151. stupid error message listed in the QUESTIONS section below:
  152.  
  153.     device=grvsultr.386
  154.     midi=ultrasnd.drv
  155.     ...
  156.     midi1=ultmport.drv
  157.     wave=ultrasnd.drv
  158.     AUX=ultrasnd.drv
  159.     mixer=ultrasnd.drv
  160.  
  161. These are the lines in your CONTROL.INI file to do the same with:
  162.  
  163.     ultmport.drv=UltraSound MIDI Port
  164.     ultrasnd.drv=Ultra Wave and MIDI Synth
  165.     ...
  166.     midi=ultrasnd.drv
  167.     midi1=ultmport.drv
  168.     wave=ultrasnd.drv
  169.     AUX=ultrasnd.drv
  170.  
  171. The next thing to change are the parameters Windows uses for the system
  172. timer which drives the MIDI playback.  Search for the following block in
  173. your SYSTEM.INI:
  174.  
  175.     [timer.drv]
  176.     TIMERMax386Res=10
  177.     TIMERMax286Res=10
  178.  
  179. Change both values from 10 to 1.
  180.  
  181. Next fire up WinOS2 and install the Roland MPU-401 drivers through the
  182. "Drivers" setup inside Control Panel.  Now go into the MIDI Mapper and
  183. create a setup called "UltraVDD".  Select the Roland MPU-401 device as
  184. the destination port for all MIDI channels and then click on "OK" to
  185. complete the setup.
  186.  
  187. If you are running full OS/2 (with IBM's WinOS2), you may wish to copy
  188. the TIMER.DRV from your real Windows SYSTEM directory to the equivalent
  189. WinOS2 directory after renaming the original.  This driver seems to give
  190. more accurate MIDI timing for Windows based MIDI sequencers.
  191.  
  192.  
  193. KNOWN BUGS AND LIMITATIONS
  194.  
  195.  - moving Ultimotion window can generate noise or loss of sound
  196.    (this seems to be fixed in Warp)
  197.  - the Digital Audio, MIDI, and Digital Video icons in the multimedia folder
  198.    are replaced with incorrect versions (these can be easily changed back
  199.    manually)
  200.  - the installation program is lacking in functionality (see STEP #3 in the
  201.    INSTALLATION section)
  202.  - MPU-401 interrupt driven recording isn't working yet (booo, hiss)
  203.  - no text in Description field for AUDIO_ADAPTER_EMULATION property
  204.    (this is a VDM limitation of OS/2 on Intel platform)
  205.  
  206.  
  207. MOST COMMONLY ASKED QUESTIONS
  208.  
  209. Q. Why don't I hear anything when using the OS/2 MIDI applet?
  210. A. If you don't have a MIDI synth connected, you won't.
  211.  
  212. A. Why don't I hear anything when using WinOS2 MIDI applications?
  213. A. If you are not a registered user and don't have a MIDI synth connected,
  214.    you won't.
  215. A. If you do have a MIDI synth, check the WinOS2 CONFIGURATION section above.
  216. A. If you are a registered user, please read the WinOS2 CONFIGURATION section
  217.    in this document and the INSTALLATION instructions included with your GM
  218.    "goody pack".
  219.  
  220. Q. Why is there a delay before hearing a system sound?
  221. A. OS/2 must swap out blocks of memory to give the MMOS2 subsystem the
  222.    storage that it needs for holding the sound sample.  When enough memory
  223.    is already free (such as immediately after a system sound), the delay
  224.    should be almost unnoticeable.
  225.  
  226. Q. Why do I get the error message "The Ultrasound driver requires enhanced
  227.    mode to run" when trying to start a full-screen WinOS2 session?
  228. A. Gravis' drivers include a Windows Virtual Device Driver (VxD != OS/2 VDD)
  229.    which cannot be loaded by OS/2 for system integrity reasons.  When the
  230.    load fails, WinOS2 (and Windows) interpret this error as the system not
  231.    running in 386 enhanced mode since that is the mode required for loading
  232.    and using VxDs.
  233.  
  234. Q. Why do my seamless WinOS2 sessions just sit there and never start?
  235. A. See Q and A above.  When the VxD load fails, WinOS2 can't continue nor
  236.    can it properly exit.  Use a session killer like Watchcat to kill it.
  237.  
  238. Q. Why doesn't SBOS or MegaEm work?
  239. A. Please read the HARDWARE EMULATIONS section.
  240.  
  241.  
  242. LEGALESE
  243.  
  244. This software is provided AS IS.  No warranty of any kind, expressed or
  245. implied, is granted including any warranties of quality or fitness for
  246. a particular purpose.  Under no circumstances will either Robert J. Manley
  247. or Multi-Player Computer Adventures be held responsible for any damage
  248. that results directly or indirectly from the use of this product.
  249.  
  250.  
  251. REGISTRATION
  252.  
  253. Please fill in the following information and send it along with a cheque
  254. or money order for $25.00 US or CAN (we need the break) to:
  255.  
  256.     Multi-Player Computer Adventures
  257.     14845-6 Yonge Street, Box 314
  258.     Aurora, Ontario, Canada
  259.     L4G 6H8
  260.  
  261.    Name: __________________________________________________
  262.  
  263. Company: __________________________________________________
  264.  
  265. Address: __________________________________________________
  266.  
  267.        : __________________________________________________
  268.  
  269.        : __________________________________________________
  270.  
  271.  e-mail: __________________________________________________
  272.  
  273.   phone: __________________________________________________
  274.  
  275. Price includes 7% GST for Canadians and 8% PST for residents of Ontario.
  276. Some future versions of this product may only be distributed commercially
  277. but will be sent free to all registered users.
  278.  
  279.  
  280. BUG REPORTS
  281.  
  282. *** NEW e-mail address ***
  283.  
  284. Please send all bug reports, gratuitous worship, whatever, to me through
  285. e-mail at: rjm@dciem.dciem.dnd.ca.  I enjoy hearing from all users.
  286.  
  287.       Problem symptom: _____________________________________________
  288.  
  289.     Fix or workaround: _____________________________________________
  290.  
  291.          OS/2 version: ______
  292.  
  293. GUS hardware revision: ___
  294.  
  295.   Daughtercard? (y/n): _
  296.  
  297.  External MIDI? (y/n): _
  298.  
  299.            GUS memory: ____ K
  300.  
  301.         System memory: __ M
  302.  
  303.  
  304. WHAT'S NEXT
  305.  
  306.     - Sound Blaster emulation to DOS sessions
  307.     - multi-track mod support at the driver level (need help here)
  308.     - MIDI synth
  309.     - Digital Audio recording
  310.     - getting Advanced Gravis to licence this software from me
  311.  
  312.  
  313. FINALLY
  314.  
  315. I cannot emphasize enough my thanks to Brent Davis and especially Linden
  316. deCarmo who have provided invaluable information when I needed it most.
  317.  
  318. Enjoy.  Robert.
  319.